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Foreword 



rd , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

32.3 1 1 : Generic Integration Reference Point (IRP) management; Requirements 

32.312: Generic Integration Reference Point (IRP) management; Information Service (IS) 

32.313: Generic Integration Reference Point (IRP) management; Common Object Request Broker 

Architecture (CORBA) Solution Set (SS) 

32.314: Generic Integration Reference Point (IRP) management; Common Management Information 

Protocol (CMIP) Solution Set (SS). 
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Scope 



The present document specifies the CORBA Solution Set for Generic Integration Reference Point (IRP) management 
whose capabiHties are specified in 3GPP TS 32.312 [1], the Generic IRP management: Information Service. 

This Solution Set specification is related to TS 32.312 V6.1.X. 



2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management: Information Service (IS)". 

[2] 3GPP TS 32.3 11: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Requirements". 

[3] 3GPP TS 32.1 1 1-2: "Telecommunication management; Alarm Integration Reference Point (IRP); 

Information Service (IS)". 

[4] 3GPP TS 32.302: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Information Service (IS)". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in TS 32.312 [1] apply. 
IRP document version number string (or "IRPVersion"): See 3GPP TS 32.31 1 [2] subclause 3.1. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CORBA Common Object Request Broker Architecture 

IDL Interface Definition Language 

IRP Integration Reference Point 

IOC Information Object Class 

OMG Object Management Group 

SS Solution Set 
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4 Architectural Features 

The overall architectural feature of this IRP is specified in 3G TS 32.312 [1]. This clause specifies features that are 
specific to the CORBA SS. 

Abstract IOC 

The capabilities of the Generic IRP management: IS [1] are captured by the definition of an IOC called 
ManagedGenericIRP. This IOC is an abstract class and is mapped to a MOC of the same name. The MOC is intended 
for inheritance by other MOCs specified in Interface IRPs such as AlarmlRP [3], NotificationIRP [4], etc. 



5. Mapping 

5.1 Operation mapping 

Generic IRP management: IS [1] defines semantics of operation visible across the Itf-N. Table 1 indicates mapping of 
these operations to their equivalents defined in this SS. 

Table 5.1 : Mapping from IS Notification/Operation to SS equivalents 



IS Operation TS 32.312 [1] 


SS Method 


Qualifier 


getlRPVersion 


get irp versions 


M 


getOperationProfile 


get interface irp operation profile 





getNotificationProfile 


get interface irp notification profile 






5.2 Operation parameter mapping 



Generic IRP management: IS [1] defines semantics of parameters carried in operations across the Itf-N. The following 
set of tables indicates the mapping of these parameters, as per operation, to their equivalents defined in this SS. 

Table 5.2 Mapping from IS getiRPVersion parameters to SS equivalents 



IS Operation parameter 


SS IVIethod parameter 


Qualifier 


versionNumberSet 


Return value of type 
GenericlRPIVIanagementConstDefsiiVersionNumberSet 


M 


status 


Exceptions: 
GenericlRPManagementSystem::GetlRPVersions 


M 



Table 5.3 Mapping from IS getOperationProfile parameters to SS equivalents 



IS Operation parameter 


SS IVIethod parameter 


Qualifier 


iRPVersion 


GenericlRPIVIanagementGonstDefs;:VersionNumber 
this irp version 


M 


operationNameProfile, 
operationParameterProfile 


Return value of type 
GenericlRPIVIanagementGonstDefs::MetliodUst 


M 


status 


Exceptions: 

GenericlRPI\/lanagementSystem::GetlnterfacelRPOperationsProfi 

le, 

GenericlRPI\/lanagementSystem::OperationNotSupported, 

GenericlRPIVIanagementSystem::lnvalidParameter, 

GenericlRPManagementSystem::ValueNotSupported 


M 
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Table 5.4 Mapping from IS getNotif icationProf lie parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


iRPVersion 


GenericlRPManagementConstDefs;:VersionNumber 
this irp version 


M 


notificationNameProfile, 
notificationParameterProfile 


Return value of type 
GenericlRPIVIanagementConstDefs::NotificationList 


M 


status 


Exceptions: 

GenericlRPI\/lanagementSystem::GetlnterfacelRPNotificationProf 

lie, 

GenericlRPI\/lanagementSystem::OperationNotSupported, 

GenericlRPIVIanagementSystem::lnvalidParameter, 

GenericlRPI\/lanagementSystem::ValueNotSupported 


M 
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Annex A (normative): 
IDL specifications 

A.1 IDL specification (file name 

'GenericlRPIVIanagementConstDefs.idI') 

//File : GenericIRPManagementConstDef s . idl 

#ifndef _GENERIC_IRP_MANAGEMENT_CONST_DEFS_IDL_ 

#define _GENERIC_IRP_MANAGEMENT_CONST_DEFS_IDL_ 

#include <TimeBase . idl> 

// This statement must appear after all include statements 

#pragma prefix "3gppsa5 . org" 

/* ## Module: GenericIRPManagementConstDef s 

This module contains definitions commonly used among all IRPs. 

*/ 

module GenericIRPManagementConstDef s 

( 

/* 

* Definition imported from CosTime. 

* The time refers to time in Greenwich Time Zone. 

* It also consists of a time displacement factor in the form of minutes of 

* displacement from the Greenwich Meridian. 
*/ 

typedef TimeBase : :UtcT IRPTime; 

typedef string DN; 

typedef sequence <DN> DNList; 

enum Signal (OK, FAILURE, PARTIAL_FAILURE } ; 
enum Result (SUCCESS, FAILURE}; 
/* 

* This holds a list of notification Ids 
*/ 

typedef sequence <long> Notif IdSet; 

/■^ 

* This holds identifiers of notifications that are correlated. 
*/ 

struct CorrelatedNotif ication 
( 

DN source;// Contains DN of MO that emitted the set of notifications 
// DN string format in compliance with Name Convention for 
// Managed Object. 

// This may be a zero-length string. In this case, the MO 
// is identified by the value of the MOI attribute 
// of the Structured Event, i.e., the notification. 
NotifldSet notif_id_set ; // Set of related notification ids 

}; 

/* 

* The VersionNumber is a string that identifies the IRP specification name 

* and its version number. See definition "IRP document version number 

* string" or " IRPVersion" . 

* The VersionNumberSet is a sequence of such VersionNumber. It is returned 

* by get_XXX_IRP_versions ( ) . The sequence order has no significance. 
*/ 

typedef string VersionNumber; 

typedef sequence <VersionNumber> VersionNumberSet; 
typedef string MethodName; 
typedef string ParameterName; 

typedef sequence <ParameterName> ParameterList ; 
/* 

* The Method defines the structure to be returned as part of 

* get_supported_operations_prof lie ( ) . The name shall be the actual method 

* name (ex. "attach„push" , "change_subscription_f liter" , etc.) 

* The parameter__list contains a list of strings. Each string shall be 

* the actual parameter name (ex. "manager_ref erence" , "filter", etc.) 
*/ 

struct Method 
( 

MethodName name; 



£75/ 



3GPP TS 32.31 3 version 6.3.0 Release 6 9 ETSI TS 1 32 31 3 V6.3.0 (2006-09) 

ParameterList parameter_list; 
}; 
/* 

* List of all methods and their associated parameters. 
*/ 

typedef sequence <Method> MethodList; 
typedef string Notif icationName; 
struct Notification 
{ 

Notif icationName name; 

ParameterList parameter_list; 
}; 

typedef sequence <Notif ication> Notif icationList; 
/* 

* Defines the name of an attribute of a Managed Object 
*/ 

typedef string MOAttributeName; 
/* 

* Defines the value of an attribute of a Managed Object in form of a CORBA 

* Any. Apart from basic datatypes already defined in CORBA, the allowed 

* attribute value types are defined in the AttributeTypes module. 
*/ 

typedef any MOAttributeValue; 
/* 

* Represents an attribute: "name" is the attribute name 

* and "value" is the attribute value. 
*/ 

struct MOAttribute 
{ 

MOAttributeName name; 

MOAttributeValue value; 
}; 

typedef sequence <MOAttribute> MOAttributeSet ; 

typedef string Managerldentif ier; 
/* 

* The following are types carrying an optional parameter. 

* If the boolean is TRUE, then the value is present. 

* Otherwise the value is absent . 
*/ 

union StringOpt switch (boolean) 



case TRUE: string value; 
union ShortOpt switch (boolean) 

case TRUE: short value; 
union UnsignedShortOpt switch (boolean) 

case TRUE: unsigned short value; 
union LongOpt switch (boolean) 

case TRUE: long value; 
union UnsignedLongOpt switch (boolean) 

case TRUE: unsigned long value; 

union IRPTimeOpt switch (boolean) 

case TRUE: GenericIRPManagementConstDef s : : IRPTime value; 
t; 

#endif // _GENERIC_IRP_MANAGEMENT_CONST_DEFS_IDL_ 



A.2 IDL specification (file name 

'GenericlRPIVIanagementSystem.idI') 

//File : GenericIRPManagementSystem. idl 
#ifndef _GENERIC_IRP_MANAGEMENT_SYSTEM_IDL_ 
#define _GENERIC_IRP_MANAGEMENT_SYSTEM_IDL_ 

#include <GenericIRPManagementConstDef s . idl> 
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// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

module GenericIRPManagement System 
{ 

exception GetlnterfacelRPNotif icationProf ile { string reason; } ; 

exception GetlnterfacelRPOperationProf ile ( string reason; }; 

exception Get IRPVersions ( string reason; }; 

/* 

Exception thrown when an unsupported optional parameter 

is passed with information. 

The parameter shall be the actual unsupported parameter name, 

*/ 

exception ParameterNotSupported { 

GenericIRPManagementConstDef s ; ; ParameterName parameter; }; 

/* 

Exception thrown when an invalid parameter value is passed. 

The parameter shall be the actual parameter name. 

*/ 

exception InvalidParameter { 

GenericIRPManagementConstDef s ;: ParameterName parameter; }; 

/* 

Exception thrown when a valid but unsupported parameter value is passed. 

The parameter shall be the actual parameter name. 

*/ 

exception ValueNotSupported { 

GenericIRPManagementConstDef s : :ParameterName parameter; }; 

/* 

Exception thrown when an unsupported optional method is called. 

V 

exception OperationNotSupported (}; 

interface GenericIRPManagement 
{ 

/* 

Return the list of all supported Interface IRP versions 

Each IRPVersion is defined by the rule in the definition 

"IRP document version number string" or "IRPVersion" 

(see subclause 3.1) . 

V 

GenericIRPManagementConstDef s : : VersionNumberSet get_irp_versions 

( 

) 

raises (GetlRPVersions) ; 

/* 

Return the list of all supported methods and their supported 

parameters for this Interface IRPVersion. 

*/ 

GenericIRPManagementConstDef s ; ;MethodList 

get_interf ace_irp_operation_prof ile 
( 

in GenericIRPManagementConstDef s ; ; VersionNumber this_irp_version 
) 
raises (Get Inter face IRPOperationProf ile, 

OperationNotSupported, 

InvalidParameter, 

ValueNotSupported) ; 

/* 

Return the list of all supported notifications and their supported 

parameters for this Interface IRPVersion. 

V 

typedef GenericIRPManagementConstDef s ; ;Notif icationList Notif icationList; 

NotificationList get_interf ace_irp_notif ication_prof ile 
( 

in GenericIRPManagementConstDef s ; ; VersionNumber this„irp_version 
) 
raises (GetlnterfacelRPNotificationProfile, 

OperationNotSupported, 

InvalidParameter, 

ValueNotSupported) ; 
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); 



); 



#endif // _GENERIC_IRP_MANAGEMENT_SYSTEM_IDL_ 
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Annex B (informative): 
Change history 



Change history 
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TSG# 


TSG Doc. 
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-- 
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0001 


— 


Correction of IDL syntax errors in 
GenericlRPManagement{ConstDefs|System}.idl 
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0002 
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